<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      6.64.&nbsp;D-Bus-1.10.14
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  </head>
  <body class="lfs" id="lfs-8.0-systemd">
    <div class="navheader">
      <h4>
        Linux From Scratch - Version 8.0-systemd
      </h4>
      <h3>
        Chapter&nbsp;6.&nbsp;Installing Basic System Software
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="patch.html" title="Patch-2.7.5">Prev</a>
          <p>
            Patch-2.7.5
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="util-linux.html" title=
          "Util-linux-2.29.1">Next</a>
          <p>
            Util-linux-2.29.1
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="chapter06.html" title=
          "Chapter&nbsp;6.&nbsp;Installing Basic System Software">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Linux From Scratch - Version 8.0-systemd">Home</a>
        </li>
      </ul>
    </div>
    <div class="wrap" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="ch-system-dbus" name="ch-system-dbus"></a>6.64. D-Bus-1.10.14
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <p>
          D-Bus is a message bus system, a simple way for applications to
          talk to one another. D-Bus supplies both a system daemon (for
          events such as "new hardware device added" or "printer queue
          changed") and a per-user-login-session daemon (for general IPC
          needs among user applications). Also, the message bus is built on
          top of a general one-to-one message passing framework, which can be
          used by any two applications to communicate directly (without going
          through the message bus daemon).
        </p>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Approximate build time:</strong>
              <span class="segbody">0.3 SBU</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Required disk space:</strong>
              <span class="segbody">22 MB</span>
            </div>
          </div>
        </div>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          6.64.1. Installation of D-Bus
        </h2>
        <p>
          Prepare D-Bus for compilation:
        </p>
        <pre class="userinput">
<kbd class="command">  ./configure --prefix=/usr                       \
              --sysconfdir=/etc                   \
              --localstatedir=/var                \
              --disable-static                    \
              --disable-doxygen-docs              \
              --disable-xml-docs                  \
              --docdir=/usr/share/doc/dbus-1.10.14 \
              --with-console-auth-dir=/run/console</kbd>
</pre>
        <div class="variablelist">
          <p class="title">
            <strong>The meaning of the configure options:</strong>
          </p>
          <dl class="variablelist">
            <dt>
              <span class="term"><em class=
              "parameter"><code>--with-console-auth-dir=/run/console</code></em></span>
            </dt>
            <dd>
              <p>
                This specifies the location of the ConsoleKit auth directory.
              </p>
            </dd>
          </dl>
        </div>
        <p>
          Compile the package:
        </p>
        <pre class="userinput">
<kbd class="command">make</kbd>
</pre>
        <p>
          This package does come with a test suite, but it requires several
          packages that are not included in LFS. Instructions for running the
          test suite can be found in the BLFS book at <a class="ulink" href=
          "http://www.linuxfromscratch.org/blfs/view/8.0/general/dbus.html">http://www.linuxfromscratch.org/blfs/view/8.0/general/dbus.html</a>.
        </p>
        <p>
          Install the package:
        </p>
        <pre class="userinput">
<kbd class="command">make install</kbd>
</pre>
        <p>
          The shared library needs to be moved to <code class=
          "filename">/lib</code>, and as a result the <code class=
          "filename">.so</code> file in <code class=
          "filename">/usr/lib</code> will need to be recreated:
        </p>
        <pre class="userinput">
<kbd class="command">mv -v /usr/lib/libdbus-1.so.* /lib
ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</kbd>
</pre>
        <p>
          Create a symlink, so that D-Bus and systemd can use the same
          <code class="filename">machine-id</code> file:
        </p>
        <pre class="userinput">
<kbd class="command">ln -sfv /etc/machine-id /var/lib/dbus</kbd>
</pre>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          <a id="contents-dbus" name="contents-dbus"></a>6.64.2. Contents of
          D-Bus
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed programs:</strong>
              <span class="segbody">dbus-cleanup-sockets, dbus-daemon,
              dbus-launch, dbus-monitor, dbus-run-session, dbus-send,
              dbus-test-tool, dbus-update-activation-environment, and
              dbus-uuidgen</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed libraries:</strong>
              <span class="segbody">libdbus-1.{a,so}</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed directories:</strong>
              <span class="segbody">/etc/dbus-1, /usr/include/dbus-1.0,
              /usr/lib/dbus-1.0, /usr/share/dbus-1,
              /usr/share/doc/dbus-1.10.14, and /var/lib/dbus</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="dbus-cleanup-sockets" name=
                    "dbus-cleanup-sockets"></a><span class=
                    "term"><span class="command"><strong>dbus-cleanup-sockets</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is used to clean up leftover sockets in a directory
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="dbus-daemon" name="dbus-daemon"></a><span class=
                    "term"><span class=
                    "command"><strong>dbus-daemon</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is the D-Bus message bus daemon
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="dbus-launch" name="dbus-launch"></a><span class=
                    "term"><span class=
                    "command"><strong>dbus-launch</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    starts <span class=
                    "command"><strong>dbus-daemon</strong></span> from a
                    shell script
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="dbus-monitor" name="dbus-monitor"></a><span class=
                    "term"><span class=
                    "command"><strong>dbus-monitor</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    monitors messages passing through a D-Bus message bus
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="dbus-run-session" name=
                    "dbus-run-session"></a><span class="term"><span class=
                    "command"><strong>dbus-run-session</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    starts a session bus instance of <span class=
                    "command"><strong>dbus-daemon</strong></span> from a
                    shell script and starts a specified program in that
                    session
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="dbus-send" name="dbus-send"></a><span class=
                    "term"><span class=
                    "command"><strong>dbus-send</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    sends a message to a D-Bus message bus
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="dbus-test-tool" name=
                    "dbus-test-tool"></a><span class="term"><span class=
                    "command"><strong>dbus-test-tool</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a tool to help packages test <span class=
                    "application">D-Bus</span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="dbus-update-activation-environment" name=
                    "dbus-update-activation-environment"></a><span class=
                    "term"><span class=
                    "command"><strong>dbus-update-activation-environment</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    updates environment variables that will be set for
                    <span class="application">D-Bus</span> session services.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="dbus-uuidgen" name="dbus-uuidgen"></a><span class=
                    "term"><span class=
                    "command"><strong>dbus-uuidgen</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    generates a universally unique ID
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libdbus-1" name="libdbus-1"></a><span class=
                    "term"><code class="filename">libdbus-1</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains API functions used to communicate with the D-Bus
                    message bus
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="patch.html" title="Patch-2.7.5">Prev</a>
          <p>
            Patch-2.7.5
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="util-linux.html" title=
          "Util-linux-2.29.1">Next</a>
          <p>
            Util-linux-2.29.1
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="chapter06.html" title=
          "Chapter&nbsp;6.&nbsp;Installing Basic System Software">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Linux From Scratch - Version 8.0-systemd">Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
